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1.0  UPGRADE  RATIONALE 

These  Release  and  Installation  Notes  apply  to  the  Rapid  Acquisition  of 
Manufactured  Parts  (RAMP)  Product  Data  Translation  System  (RPTS)  for  Small 
Mechanical  Parts  (SMP).  The  installation  of  RPTS  SMP  Version  3.2  upgrade  is 
addressed  herein.  Version  4.0  was  developed,  at  the  direction  of  the  RAMP 
Program  Office,  to  implement  certain  improvements  in  the  South  Carolina  Research 
Authority  (SCRA)  developed  software  and  to  install  the  latest  version  of  the 
vendor  supported  software. 
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2.0  INVENTORY  OF  MATERIALS  RELEASED 
The  RPTS  SMP  Version  4.0  release  package  consists  of  the  following: 

1.  Release  and  Installat! jn  Instructions 

2.  Backup  Media  (delivered  to  Rock  Island  on  April  6,  1992) 

Two  1/4"  cartridge  tapes  delivered  to  Rock  Island 
RPTS  SMP  Version  4.0  Executables 

RPTS  SMP  Version  4.0  Developer's  Distribution  PDES  Translator  and 
Supporting  Text  Files  tape 

Three  1/4"  cartridge  tapes  stored  in  the  South  Carolina  Research  Authority 
(SCRA)  Master  Software  Library  (MSL) 

RPTS  SMP  Version  4.0  Executables 

RPTS  SMP  Version  4.0  Developer's  Distribution  PDES  Translator  and 
Supporting  Text  Files  tape 
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3.0  POSSIBLE  PROBLEMS  AND  KNOWN  DEFICIENCIES 


It  has  been  determined  that  there  are  outstanding  Problem  Reports  (PR) 
requiring  action. 


Summary  of  outstanding  PRs. 


PR  # 

Description 

Status 

Workarounds 

RP202 

PDES  entity  "material_ 
composition"  string  field 
entry  is  truncated  and  is 
appended  by  the  string 
"null"  at  the  end. 

Open 

See  RP203 

RP203 

PDES  printout  contains 
about  two  pages  of  material 
composition  data  because  the 
operator  was  allowed  to  cancel 
before  entering  all  of  the 
necessary  composition. 

Open 

Operator  must 
enter  all  required 
data  and  do  not 
cancel 

RP205 

PDES  Generation  incomplete. 
"Error: area  shaped  ID  not 
found  for  surface  reference" 

Open 

none 
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4.0  INSTALLATION  INSTRUCTIONS 

The  following  instructions  will  allow  the  user  to  install  the  RPTS  SMP 
Version  4.0  on  the  Rock  Island  SPARCStation. 


U.  Installation  of  Parametric  Technology  Corporation's  fPTCl  Pro/DEVELOP 
End-User  Distribution 

A.  Pro/ENGINEER  must  be  loaded  on  this  machine.  You  will  need  to 
know  the  directory  in  which  Pro/ENGINEER  has  been  installed. 

1.  Install  Pro/DEVELOP  end-user  distribution.  This  is  the  POES 
Translation  program.  This  may  be  installed  anywhere  you  have 
at  least  5  Mb  of  space  available. 

a.  Insert  distribution  tape  into  tape  drive  (check  to  ensure 
write-protection). 

b.  Follow  instructions  in  Pro/ENGINEER  8.0  Installation  Guide. 

1.  You  will  need  to  know  the  "name  of  product"  -  this  is 
"convert_pdes". 

2.  You  will  be  asked  for  an  installation  directory  for 
product  -  this  cannot  be  the  Pro/ENGINEER  loadpoint, 
.../rpgs  OR  .../rpgsad.  The  path  to  the  product  is  the 
distribution  directory  name  followed  by  two 
subdirectories  as  in  : 

$DIST_DIR/sun4/obj/convert_pdes 

4^  Configure  ORACLE  User  Logins  and  Database  Performance  Tuning 

A.  Log  in  as  the  Oracle  user  (this  is  typically  "oracle").  Oracle  should 
be  installed  with  a  database  size  of  at  least  20  Mb. 

B.  Create  two  database  user  logins>  one  for  the  Order  Manager  database 
and  one  for  the  POES  database. 

sqiplus  system/manager 

GRANT  CONNECT,  RESOURCE  TO  <order  mgr_db_login>,  <pdes_dbJogin> 
IDENTIFIED  BY  <order_mgr_db_passw3>,  <pdes_db_passwd>; 

You  may  choose  the  names  for  the  database  logins  and  passwords.  It  is 
suggested  that  they  are  not  too  long.  Examples: 
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Database  Name  Password 

ordermgr  pdes 

genpds  pdes 


C.  Shut  down  currently  running  database. 

1.  cd  $ORACLE_HOME/bin 

2.  dbshut 

D.  Modify/add  parameters  in  "init*.ora"  file  in  $ORACLE_HOME/dbs  as 

follows: 

ddl_locks  -  100 
dml_1ocks  -  200 
processes  -  30 
enqueue_resources  »  700 
open_cursors  -  100 
dc_free_extents  •  400 
row_cacHe_enqueues  -  400 

E.  Restart  database  with  new  initialization  parameters. 

1.  cd  $0RACLE_H0ME/bin 

2.  dbstart 

O  Installation  of  RPTS  Software  and  Supporting  Utilities 

A.  Create  RPTS  user  and  RPTS  Administrator  user  system  logins. 

1.  Create  two  user  logins,  one  for  the  RPTS  user  and  one  for  the 
RPTS  Administrator  user.  In  this  example,  we  will  use  RPTS  and 
RPTSAD  as  the  user  logins.  The  home  directory  for  the  RPTS  user 
must  have  at  least  30  Mb  of  space.  This  will  allow  approximately 
18  Mb  of  space  for  the  /PDES  FILES  directory  to  store 
Pro/ENGINEER  part  files,  PDES  fiTes,  et  cetera.  The  home 
directory  for  the  RPTSAD  user  must  have  at  least  1.5  Mb  of 
space.  The  home  directory  paths  for  each  of  these  logins  must  be 
adjusted  AFTER  the  installation  is  complete.  After  the 
installation,  each  loadpoint  will  have  a  subdirectory 
".../rpgs"  for  the  RPTS  user  and  ".../rpgsad"  for  the  RPTSAD 
user.  These  will  be  the  new  "HOME"  directories  for  each  user. 

B.  Install  RPTS  software. 
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1.  Log  in  as  the  RPTS  user.  This  will  be  the  loadpoint  for  the  RPTS 
system. 

2.  Insert  RPTS  Executables  tape  into  tape  drive  (check  to  ensure 
write-protection) . 

3.  tar  xvf  /dev/nrstO  (or  whatever  your  tape  device  name  may  be  -  be 
sure  to  specify  the  device  as  "no  rewind"). 

If  the  tape  drive  is  located  on  a  remote  machine  on  your  network 
use  this  command: 

rsh  -n  <remote_machine>  dd  i f »/dev/nrstO  |  tar  xvBf  - 

4.  Once  the  tar  command  is  complete,  check  for  file  extraction.  You 
should  now  see  a  new  subdirectory:  ./rpgs. 

5.  Log  in  as  "root"  and  adjust  the  RPTS  user  home  directory  to 
contain  the  new  subdirectory  just  created. 

6.  Log  in  as  the  RPTS  user.  Change  permissions  on  User  Defined 
Feature  (UDF)  files  since  they  may  have  been  extracted  from  tape 
with  a  different  permission  mask. 

a.  Log  in  as  the  RPTS  user.  You  should  now  be  in  the  "new" 
RPTS  home  directory.  Now  cd  ./udfs. 

b.  chmod.csh 

7.  Modify  the  login_order.db,  login_pdes.db  and  config.pro  files. 

a.  Change  directory  to  ../bin  ($RPGS_HOME/bin) . 

b.  Change  the  database  login  and  password  in  each  file  to 
match  the  database  logins  and  passwords  which  you  have 
created  (see  section  II).  The  file  login  order. db  contains 
the  Order  Manager  database  login  on  the  first  line  and  the 
Order  Manager  database  password  on  the  second  line.  The 
file  login_pdes.db  contains  the  PDES  database  login  on  the 
first  line  and  the  PDES  database  password  on  the  second 
line. 

c.  Change  directory  to  . ./rpgs_scripts/scripts 
( $RPGS_HOME/rpgs_scri pt s/scri pt s ) . 

d.  Modify  the  line  "pro_group_dir  ../../udfs"  to  contain  the 
entire  ABSOLUTE  directory  path  for  SRPGS  HOME/udfs  without 
using  environment  variables  in  the  file  ^config.pro". 


9 


RTIF  PROGRAM  DOCUMENT  NO. :  V0R015003-0 

17  APRIL  1992 


e.  Modify  de1_a11.sh  In  same  directory 
($RPGS_HOME/rpgs_scripts/scripts)ONLY  IF  your  database 
password  for  the  POES  database  is  NOT  "pdes”.  You  will  see 
a  line  "pwd-POES”.  Modify  the  password  setting  if  you  have 
not  specified  "pdes”  as  the  password  in  the  GRANT  command. 

C.  Install  the  RPTS  Admin  software. 

1.  Log  in  as  the  RPTSAD  user.  This  will  be  the  loadpoint 
for  the  RPTS  Admin  system. 

2.  RPTS  Executables  tape  should  already  be  in  tape  drive.  If 
,  not,  insert  RPTS  executables  tape  into  tape  drive  (check  to 

ensure  write-protection).  Use  the  following  command  to 
advance  the  tape  to  the  RPTS  Admin  files: 

mt  -f  /dev/nrstO  fsf  1 

If  the  tape  drive  is  located  on  a  remote  machine  on  your 
network  use  this  command: 

rsh  -n  <remote_machine>  "mt  -f  /dev/nrstO  fsf  1" 

3.  tar  xvf  /dev/rstO  (or  whatever  your  tape  device  name  may 
be). 

If  the  tape  drive  is  located  on  a  remote  machine  on  your  network 
use  this  command: 

rsh  -n  <remote_machine>  dd  if«/dev/nrstO  |  tar  xvBf  - 

4.  Once  the  tar  command  Is  complete,  check  for  file  extraction. 
You  should  now  see  a  new  subdirectory:  ./rpgsad 

5.  Log  in  as  "root"  and  adjust  the  RPTSAD  user  home  directory 
to  contain  the  new  subdirectory  just  created. 

6.  Modify  the  login_order.db  file. 

a.  Log  in  as  the  RPTSAD  user.  You  should  now  be  in  the 
"new"  RPTSAD  home  directory. 

b.  Change  the  database  login  and  password  in 

1ogin_order.db  to  match  the  database  login  and  password 
creatid  for  the  Order  Manager  database.  The 

login^order.db  contains  the  Order  Manager  database 
login'on  the  first  line  and  the  Order  Manager  database 
password  on  the  second  line. 
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iA  Configure  RPTS  and  RPTSAD  Environments 

A.  A  sample  ".login"  and  ".cshrc"  file  is  provided.  You  may  customize 
the  RPTS  and  RPTSAO  environments  provided  that  the  following 
environment  variables  are  set  in  the  ".login"  and  ".cshrc"  files  for 
EACH  user,  RPTS  and  RPTSAD.  In  the  ".login"  ONLY: 

RPGS_PRO  CMD  :  set  to  your  command  for  running  Pro/ENGINEER 
ORACLE_HOST  :  machine  host  name  where  Oracle  is  installed 
ORACLE_SID  :  Oracle  system  identifier 

(specified  in  installation) 

0RACLE_H0ME  :  Oracle  home  directory 

In  the  .login  AND  .cshrc  files  : 

RPGS_SCRIPTS_DIR  :  $RPGS_HOME/rpgs_scripts 

[Use  absolute  path  name] 

SPG.DIRECTORY  :  Pro/ENGINEER  loadpoint 

Of  course,  you  may  use  the  ".login"  and  ".cshrc"  files  provided,  but 
they  must  be  modified  to  contain  your  site-specific  information  such 
as  machine  host  names,  file  directory  paths,  et  cetera.  Be  sure  to 
delete  or  comment  out  any  commands  which  do  not  pertain  to  your 
installation  site. 


4^  Create  Database  Tables  for  the  Order  Manager  and  for  the  PDES  Translator 

A.  Log  in  as  the  RPTS  user. 

1.  cd  ./db_scripts  ($RPGS_HOME/db_scripts) . 

2.  To  create  tables  for  the  Order  Manager  (using  the  DB  login  and 
password  from  our  example  in  section  II  B): 

sqlplus  ordermgr/pdes  <  create_tables.sq1 

3.  To  create  tables  for  the  POES  Translator  (using  the  DB  login  and 
password  from  our  example  in  section  II  B): 

make_smp_tables.sh  genpds  pdes 

This  may  take  several  minutes,  please  be  patient. 
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